home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / nlist.man < prev    next >
Encoding:
Text File  |  1989-01-27  |  1.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. NLIST                 C Library Procedures                  NLIST
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      nlist - get entries from name list
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ##iinncclluuddee <<nnlliisstt..hh>>
  13.  
  14.      nnlliisstt((ffiilleennaammee,, nnll))
  15.      cchhaarr **ffiilleennaammee;;
  16.      ssttrruucctt nnlliisstt nnll[[]];;
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      _N_l_i_s_t examines the name list in the given executable output
  20.      file and selectively extracts a list of values.  The name
  21.      list consists of an array of structures containing names,
  22.      types and values.  The list is terminated with a null name.
  23.      Each name is looked up in the name list of the file.  If the
  24.      name is found, the type and value of the name are inserted
  25.      in the next two fields.  If the name is not found, both
  26.      entries are set to 0.  See _a._o_u_t(5) for the structure
  27.      declaration.
  28.  
  29.      This subroutine is useful for examining the system name list
  30.      kept in the file //vvmmuunniixx.  In this way programs can obtain
  31.      system addresses that are up to date.
  32.  
  33. SSEEEE AALLSSOO
  34.      a.out(5)
  35.  
  36. DDIIAAGGNNOOSSTTIICCSS
  37.      If the file cannot be found or if it is not a valid namelist
  38.      -1 is returned; otherwise, the number of unfound namelist
  39.      entries is returned.
  40.  
  41.      The type entry is set to 0 if the symbol is not found.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0               May 15, 1985                          1
  64.  
  65.  
  66.  
  67.